Inside Macintosh: QuickTime Components /

Chapter 8 - Video Digitizer Components / Video Digitizer Components Reference

Video Digitizer Component Functions / Selectively Displaying Video

VDGetKeyColor

The VDGetKeyColor function allows your application to obtain the index value of the active key color.

All video digitizer components that support key colors must support this function.

pascal VideoDigitizerError VDGetKeyColor
                                  (VideoDigitizerComponent ci,
                                     long *index);

ci

Specifies the video digitizer component for the request. Applications obtain this reference from the Component Manager's OpenComponent function.

index

Contains a pointer to a field that is to receive the index of the key color. This index value identifies the key color within the currently active color lookup table. If there are several active key colors, the video digitizer returns the first color from the key color list. Subsequently, applications use the VDGetNextKeyColor function (described on page 8-86) to obtain other colors from the list. If there is no active key color, the VDGetKeyColor function sets the field to -1.

DESCRIPTION

In cases where there are several key colors, the VDGetKeyColor function always returns the index of the first color in the list. Applications should then use the VDGetNextKeyColor function (described on page 8-86) to retrieve the remaining colors in the list.

RESULT CODES

noErr	0	No error
digiUnimpErr	-2201	Function not supported

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help